home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / 4dview.1 next >
Text File  |  1993-11-16  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. 4dview(1)         Geomview Module        4dview(1)
  5.  
  6.  
  7. NAME
  8.        4dview  - interactively display and slice projections of    a
  9.        4 dimensional object
  10.  
  11. SYNOPSIS
  12.        4dview
  13.  
  14. DESCRIPTION
  15.        4dview is an interactive    program     for  displaying  projec-
  16.        tions  of  4-dimensional     geometric objects on an Iris. It
  17.        was designed specifically to be used as an external module
  18.        for geomview.
  19.  
  20.        The program works by reading in a text file specifying the
  21.        geometry    of the 4-D object, then    sending    a stream  of  3-D
  22.        projections of the object via standard output to    geomview.
  23.        The input file must contain the geometry    of the object  in
  24.        one  of    the  oogl  formats (see    OOGL objects). Typing the
  25.        name of the input file into the space provided on the main
  26.        panel,  and  clicking  on load will bring the object up on
  27.        the display.
  28.  
  29.        In addition to the main panel, 4dview has three sub-panels
  30.        containing features that    allow the user to modify the pro-
  31.        jection and actual geometry of the  object  being  viewed.
  32.        The first and most frequently used panel    is the projection
  33.        panel which can be reached by clicking on  the  button  of
  34.        the same    name in    the main panel.
  35.  
  36.        To  change  the    projection,  use the left and right mouse
  37.        buttons while dragging across the 'Projection  axis'  con-
  38.        troller    on  the    projection panel.  The left mouse adjusts
  39.        the direction, and the right mouse adjusts the length,  of
  40.        the red segment.     It extends from the origin to a point in
  41.        the unit    ball, and specifies a direction    (a  unit  vector)
  42.        in 4-space as follows: the vector's (x,y,z) components are
  43.        those of    the segment's tip, and its w component is  chosen
  44.        to  form    a unit vector in the positive w    hemisphere.  Here
  45.        x extends rightward, y toward the viewer,  z  upward.   So
  46.        when  the red segment has zero length, the projection axis
  47.        is entirely in the w direction i.e. (0,0,0,1), and when it
  48.        reaches    the  top  of  the  ball,  the  projection axis is
  49.        (0,0,1,0).  The blue segments are perpendicular to the red
  50.        axis,  and  reach  to  the  surface  of the ball.  They're
  51.        intended    only  as  perspective  cues,  so  altering  their
  52.        direction does not change the 4-D projection.
  53.  
  54.        The  speed  at which the    projection changes depends on the
  55.        complexity of the object. One may also type in a    new  pro-
  56.        jection matrix explicitly, in the space provided. Clicking
  57.        on the 'Default Projection' button will cause the  projec-
  58.        tion matrix to revert to    the identity matrix.
  59.  
  60.        Another sub-panel is the    features sub-panel. This panel is
  61.  
  62.  
  63.  
  64.               June 20, 1992                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. 4dview(1)         Geomview Module        4dview(1)
  71.  
  72.  
  73.        for when    new features will be added to 4dview. At  present
  74.        the only    additional feature is the capability of    switching
  75.        between two different projection    schemes, Perspective  and
  76.        Orthogonal  projection.    Other features such as color con-
  77.        trol and    perhaps    animation will most likely be added here.
  78.  
  79.        To   facilitate    understanding  of  the    4th-dimension  in
  80.        4dview, vertices    are associated with  a    particular  color
  81.        depending  upon    how far    away they are from the projection
  82.        hyperplane. Using smooth    shading    mode (see geomview)  will
  83.        allow  one to see a gradient in color along the surface of
  84.        the object.  Vertices that are further away become  redish
  85.        while vertices that are nearer become blueish.
  86.  
  87.        Beyond  projection,  the     4dview    module also allows one to
  88.        slice off part of an object with     a  hyperplane.     This  is
  89.        useful  in  the    case where one wants to    see the    inside of
  90.        the object or get rid of    irrelevant parts of  the  object.
  91.        This  slicing  feature is available when    one brings up the
  92.        slicing sub-panel.
  93.  
  94.        To control the orientation of the slicing  hyperplane  one
  95.        drags  across  the  'Slicing  plane axis' with the left or
  96.        right mouse button or enters  numbers  into  the     provided
  97.        spaces  that explicitly define its orientation. To control
  98.        the depth of the    hyperplane one adjusts the 'Slice  Depth'
  99.        slider or enters    a value    into the depth value box.
  100.  
  101.        As  the position    of the hyperplane changes, vertices which
  102.        are on the side of the hyperplane being    clipped     are  now
  103.        colored    white. This provides a rough idea of what will be
  104.        gone when we actually slice. Clicking on    the 'Flip' button
  105.        will  change  the side of the hyperplane    on which clipping
  106.        is being    performed. Clicking on the  'Slice'  button  will
  107.        then perform the    actual clipping.
  108.  
  109.        Any  changes  to     the  geometry    of the object produced by
  110.        slicing can be saved by typing in the name of the file  to
  111.        store  the  changed  object  into,  and    then  clicking on
  112.        'Store'.    The stored object is always in    the  4OFF  format
  113.        regardless  of the format the object was    originally stored
  114.        in.
  115.  
  116. BUGS
  117.        This is the first release of the    program    so there could be plenty.
  118.        Please report any you may find to me.
  119.  
  120. SEE ALSO
  121.        geomview(1) oogl(5)
  122.  
  123. AUTHOR
  124.        Daeron Meyer        email: daeron@geom.umn.edu
  125.        The Geometry Center    phone: (612) 626-8302
  126.        1300 South Second Street
  127.  
  128.  
  129.  
  130.               June 20, 1992                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. 4dview(1)         Geomview Module        4dview(1)
  137.  
  138.  
  139.        Minneapolis, MN 55454
  140.  
  141.        Many thanks to Stuart Levy for the projection axis controller and
  142.        considerable help in debugging this program. Also, thanks to Celeste
  143.        Fowler for her tool which allows    my program to be able to handle    all
  144.        oogl object file    formats.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.               June 20, 1992                3
  197.  
  198.  
  199.